home *** CD-ROM | disk | FTP | other *** search
/ Eagles Nest BBS 7 / Eagles_Nest_Mac_Collection_Disc_7.TOAST / Internet⁄Other Nets / IntStartKit / TurboGopher.rsrc / TEXT_5000_HeLp.txt < prev    next >
Text File  |  1993-09-02  |  25KB  |  484 lines
  1. ======      Definitions      ======
  2.  
  3.     Gopher  n.  1. Any of various short tailed, burrowing mammals of the
  4.     family Geomyidae, of North America.  2. (Amer. colloq.) Native or
  5.     inhabitant of Minnesota: the Gopher State.   3.  (Amer. colloq.) One
  6.     who runs errands, does odd-jobs, fetches or delivers documents for
  7.     office staff.  4. (Computer tech.) software following a simple
  8.     protocol for burrowing through a TCP/IP internet.
  9.  
  10.     Gopher+  n.  1. Hardier strains of mammals of the family 
  11.     Geomyidae.  2. (Amer. colloq.) Native or inhabitant of Minnesota, 
  12.     the Gopher state, in full winter regalia (see PARKA).  3. (Amer. 
  13.     colloq.) Executive secretary.  4. (computer tech.) Software 
  14.     following a simple protocol for burrowing through a TCP/IP 
  15.     internet, made more powerful by simple enhancements 
  16.     (see CREEPING FEATURISM).
  17.  
  18.     TurboGopher  n.  1. A small rodent with a turbocharger strapped on
  19.     its back to increase its speed and ferocity.  2. (Amer. colloq.)
  20.     Native or inhabitant of Minnesota after consuming three double
  21.     espressos. 3. (Amer. colloq.) An Olympic sprinter who runs errands,
  22.     does odd-jobs, fetches or delivers documents for office staff.  4.
  23.     (computer tech.) Speed-optimized Macintosh software following a
  24.     simple protocol for burrowing through a TCP/IP internet; network
  25.     speed is achieved by using turbocharged software; incoming bits spin
  26.     the turbine that pumps out the outgoing bits.
  27.  
  28.  
  29. ======      Overview      ======
  30.  
  31. TurboGopher is a Macintosh application that we believe is (still!)
  32. the fastest Macintosh Gopher client available. Beyond optimizing 
  33. TurboGopher for raw speed while fetching documents and directories, 
  34. we turbocharged the user interface by displaying information as soon 
  35. as possible... you can read the first part of a document or directory 
  36. while the rest is being fetched. This version of TurboGopher also supports 
  37. the Gopher+ extensions to the original Internet Gopher protocol. 
  38.  
  39. In spite of the design goal to run fast as possible, TurboGopher is a good 
  40. Mac citizen: it shares time with other applications. You can put
  41. TurboGopher in the background to fetch lengthy items in the background 
  42. while you work in another application in the foreground. 
  43.  
  44.  
  45. ======      What is Gopher?      ======
  46.  
  47. The Internet Gopher protocol and the first Gopher software was 
  48. developed by the Gopher Team at the University of Minnesota. Gopher 
  49. was originally created as a fast, simple, distributed, campus-wide 
  50. information search and retrieval system. Ease of use and implementation 
  51. has made Gopher increasingly popular on the Internet. Since its original 
  52. release, many folks on the Internet have contributed to its growth, 
  53. submitting patches, servers, clients, and linking their local servers into 
  54. the worldwide network of Gopher servers. Now there are even gateways 
  55. to seamlessly access a variety of non-Gopher services such as FTP,  
  56. Archie, WAIS, USENET news, whois servers, etc. This network of Gopher 
  57. servers is at your disposal from a Mac, PC, or workstation  connected to 
  58. the Internet. Incidentally, TurboGopher, the Internet Gopher protocol, and 
  59. the Gopher+ extensions are copyright ¬© 1991-1993 by the University of 
  60. Minnesota.
  61.  
  62. The Gopher software may be retrieved from numerous Gopher or FTP 
  63. archive sites, including the University of Minnesota Gopher server, the 
  64. Info-Mac Archive Gopher server, and by anonymous FTP from 
  65. boombox.micro.umn.edu and sumex-aim.stanford.edu.  The most recent 
  66. release of TurboGopher is always available from the University of 
  67. Minnesota Gopher server (or by anonymous ftp from 
  68. boombox.micro.umn.edu).  If you discover a bug or just want to know if 
  69. you have the newest version, read the file called 'ReadMe-Versions-
  70. Bugs'.  The version number of your TurboGopher may be found by 
  71. choosing 'About TurboGopher' from the Apple Menu or by clicking on 
  72. the application's icon in Finder and choosing 'Get Info' from the Finder's 
  73. File menu.
  74.  
  75.  
  76. ======      How does it work?      ======
  77.  
  78. Information accessible via Gopher is stored on many computers all over 
  79. the Internet. These computers are called Gopher servers. Information 
  80. stored on many kinds of non-gopher servers is also available via special 
  81. gopher servers that act as gateways (protocol translators). Virtually any 
  82. popular computer (Mac, Unix box, PC, or larger computer) can be used 
  83. as a server. Servers do not just contain files, directories and searchable 
  84. databases; they can also contain references to other servers. To retrieve 
  85. and search this information, you need to run a Gopher client application 
  86. on your computer. TurboGopher is a Gopher client application. You can 
  87. set it up to remember how to connect to one server; from here you can 
  88. effortlessly traverse the web of all interlinked servers.
  89.  
  90.  
  91. ======      Getting Help with TurboGopher      ======
  92.  
  93. In addition to this information you are reading right now, if you are 
  94. using System 7 (and we strongly recommend that you do, as many
  95. TurboGopher features are only available under System 7), some Balloon 
  96. Help is available in TurboGopher.  See your Macintosh System 7 
  97. documentation for information on using Balloon Help.
  98.  
  99.  
  100. ======      Using TurboGopher      ======
  101.  
  102. TurboGopher uses MacTCP to communicate with gopher servers on a 
  103. network. Assuming your Mac has correctly configured MacTCP software 
  104. installed in the System Folder, TurboGopher is all set to go.
  105.  
  106.  
  107. ======      Navigating Gopherspace      ======
  108.  
  109. To navigate through gopherspace, double-click on any interesting items 
  110. to open (fetch) them. If you double-click on a file, TurboGopher will 
  111. fetch and display the file. Opening a folder will let you view its contents.
  112. Double-clicking on the question-mark (Search) icons will let you search a 
  113. database. On most gopher servers these databases are full-text indexes of a 
  114. collection of information. Full-text index means that every word in every 
  115. document is considered a keyword. The best way to search a gopher full-text 
  116. database is specify the words for which to search when TurboGopher 
  117. presents you with a dialog box. The results of the search are returned as a
  118. list of documents containing those words.
  119.  
  120. If you double-click on the phone-book icons you can search electronic 
  121. phone books. Phone book databases are structured in the sense that 
  122. they have fields (i.e. a name field, an address field, and a phone number 
  123. field). The simple phone-book lookup dialog assumes that you want to 
  124. search for someone by name.  Click on the 'More Choices' button if you 
  125. wish to specify exactly which fields to search in, when you formulate a 
  126. query. The result of the query is displayed in a document.
  127.  
  128. Disk icons represent archived Mac software or documents that you can 
  129. fetch; these items will be saved to your hard disk.  Such items are often 
  130. stored in compressed form to save space.  You need to have certain Mac 
  131. utilities to 'uncompress' such items.  The most common such utilities are 
  132. StuffIt and Compactor.  Both may be obtained from the Info-Mac archives 
  133. with gopher.  If you are running System 7 and TurboGopher retrieves an 
  134. item that needs to be 'unstuffed' or 'uncompacted', it will ask you if it 
  135. should open them via Finder and the appropriate decompress utility.  We 
  136. recommend that you use CptExpand and SitExpand for your decompress 
  137. needs; both of these are available with the TurboGopher software 
  138. distribution as Helper Applications as well as from the Info-Mac archives.
  139.  
  140. Items that are specific to MS-DOS are seen as documents with a tiny 
  141. 'PC' emblazoned on them; similarly items specific to UNIX show up as 
  142. documents with a tiny 'UX' on them.  You can retrieve either of these 
  143. kinds of items if you like.  TurboGopher will ask you if you wish to save 
  144. them to your disk.  You may not 'view' these items as text.  In fact it 
  145. will probably make very little sense to fetch such items unless you intend 
  146. to further transfer them later from your Mac to another kind of computer, 
  147. or if you have some special tools on your Mac that will allow you to use 
  148. these kinds of items.
  149.  
  150. Items appearing as documents with a starburst on them are probably 
  151. graphics or picture files (typically in GIF, JPEG, or PICT format).  
  152. TurboGopher will transfer such files, save them on your disk, and 
  153. optionally launch a picture-viewing helper application if you wish
  154. to view the picture.
  155.  
  156.  
  157. ======      Alternate Views      ======
  158.  
  159. Gopher+ servers may store more than one representation of a document 
  160. (an image, text, sound, video, etc. ). If more than one view of a document 
  161. is available, you can select between the views by choosing the 'Get 
  162. Alternate Views' item from the Gopher menu. When alternate views 
  163. are available, an alternate view window will be displayed with 
  164. descriptions of the views.
  165.  
  166. For many alternate views of documents, TurboGopher will save a copy of  
  167. the item to your Macintosh's disk, and then (under System 7) optionally
  168. ask the Finder to open the item with a helper application. 
  169. You can configure which applications should be used as TurboGopher 
  170. helpers; to do this see the section on configuration options.
  171.  
  172.  
  173. ======      Connecting to terminal-based services      ======
  174.  
  175. Opening the 'terminal' icons will make TurboGopher launch NCSA 
  176. Telnet (or TN3270 if appropriate) and start a terminal session to a 
  177. terminal-based information system. Typically these are library catalogs or 
  178. other such services. Note that for this to work, you need to have Telnet or 
  179. TN3270 installed on your Macintosh. If you are still running System 6, 
  180. TurboGopher will only save a Telnet session file rather than launch 
  181. Telnet; this is another good reason to run System 7 on your Mac.
  182.  
  183. Following the Macintosh guidelines, TurboGopher starts out
  184. displaying text in the standard application font.  The Font and
  185. Size menu items let you change font appearance for documents and
  186. lists.  TurboGopher will attempt to display phonebook lookup
  187. results in a monospaced font (Monaco), effectively ignoring your
  188. font selection.  It IS possible to change the font of a phonebook
  189. results lookup window after it has been opened; however things will
  190. not line up correctly and generally look icky.
  191.  
  192.  
  193. ======      Advanced Navigation Features  & Shortcuts    ======
  194.  
  195. If you double-click on a folder while holding down the Option key, 
  196. TurboGopher will re-use the current window instead of using a new one 
  197. to display the folder contents. Some folks like to do this to prevent
  198. screen clutter and keep from having too many open windows.
  199.  
  200. You may use the up and down arrow keys on your keyboard to move up 
  201. and down lists in windows. The Enter or Return key opens an item (and is 
  202. equivalent to double-clicking on an item).  Use of the arrow keys
  203. is not supported on the Mac Plus.... (sorry).
  204.  
  205. You may also type the first letter (or first few letters) of an item
  206. name in a  list and TurboGopher will highlight the first item it
  207. finds that matches (sort of like the Finder does in list views). 
  208. The Find menu item is available to locate an item in a list: just
  209. type a string in the Find dialog.  Find can also be used to search
  210. for text in open document windows, by the way.
  211.  
  212. To delete any item in any list window, click once on the item to
  213. select it. Then choose 'Delete Item' from the Gopher menu. 
  214.  
  215. TurboGopher remembers the last full-text index search (item with 
  216. question-mark icon) you used. If now you hold down the Option key and 
  217. double-click on a word in a document window, TurboGopher will query 
  218. that search service for all documents containing the word you selected. 
  219. You must use a search service before this pseudo-hypertext capability is 
  220. accessible (TurboGopher needs to know which search service to use in 
  221. your hypertext query).
  222.  
  223. The Recent menu lets you go back to any directory window you have 
  224. viewed during your Gopher session. The left and right arrow keys may be 
  225. used to go to previous or next windows; they are equivalent to traversing 
  226. the recent menu upwards or downwards.  Note that the Recent menu 
  227. only remembers directory windows you visit. Document or phone-book
  228. lookup windows are not listed.
  229.  
  230. Pressing the escape key in a list window causes TurboGopher to dump
  231. the contents and do a transaction to fetch an up-to-date listing.
  232.  
  233. If you hold down the Command Key while clicking on the title of a 
  234. window, the path you took to get there is displayed (much like the
  235. Finder does for its windows).  Further, Command-Up arrow lets you
  236. move back up to a directory's parent (enclosing) directory.
  237. Command-Down arrow moves down a directory.
  238.  
  239. Also, Command-shift-Left arrow and Command-shift-Right arrow move
  240. you through the children of one specific parent (enclosing) directory.
  241.  
  242. If you close a window by clicking in its close box while holding down the 
  243. Option key, then (like Finder) TurboGopher will close all open windows.  
  244.  
  245. If you click in the close box while holding down the Shift key, then the
  246. window will be closed and if it is a list, it will also be forgotten. In
  247. other words, it will be removed from the Recent menu.
  248.  
  249. Of course, if you hold down both Option and Shift keys then all windows 
  250. are closed and forgotten.
  251.  
  252. For the terminally curious, if you hold down the Shift key while single
  253. clicking on an item in a list, TurboGopher will display the item's Gopher
  254. selector string, host name, port number and Gopher+ baggage in the
  255. status pane.  This is a quick peek.  If you want to copy-paste this
  256. information, use the Get Attribute Info menu item found under the Gopher 
  257. menu; the information you want is in the +INFO attribute (the first line).
  258.  
  259. If wish to fetch an item that is a Macintosh file (binhexed file,
  260. shows up with the icon of a disk), but don't want TurboGopher to
  261. automatically dehex it as it fetches, you may force TurboGopher to
  262. fetch the document as a raw, unprocessed file.   To do this, hold
  263. down the Control key while you double-click on the item.   For
  264. folks using DownLine or other applications for de-binhexing and
  265. de-archival, this is one way to do what you want. 
  266.  
  267.  
  268. ======      Authenticated Servers      ======
  269.  
  270. TurboGopher now supports AdmitOne Authentication for Gopher+ servers
  271. that restrict access to information on a per-user basis.  When you
  272. attempt to open a directory that has such access restrictions,
  273. TurboGopher will prompt you for your username and password on the
  274. restricted-access server.  TurboGopher and the server negotiate to
  275. establish a valid ticket, and subsequent requests to the server use
  276. a new ticket for each request. This means that your password is
  277. not sent over the network, and that you only have to enter your 
  278. password to get the initial authorization.
  279.  
  280.  
  281. ======      Bookmarks and Bookmark Files      ======
  282.  
  283. If you formulate a search or find a folder you would like to come back to 
  284. quickly later, you can use the Set Bookmark menu item to save your 
  285. place.  Set Bookmark saves a reference to a folder, file, search, terminal 
  286. session... in fact any Gopher item.  If nothing is selected in the front 
  287. list window, a bookmark is made for a folder representing the window. Try 
  288. it, it's easier to do than to say.
  289.  
  290. Bookmarks are placed in a special Bookmarks window. Use the Show 
  291. Bookmarks menu item to open the Bookmarks window. Bookmarks are 
  292. remembered even after you quit TurboGopher; contents of the Recent 
  293. menu are however forgotten. It might be useful to consider the 
  294. Bookmarks window to be a special kind  of 'worksheet' or 'construction 
  295. area' for you to build your own scratch-pad of useful gopher resources.
  296.  
  297. You may edit the names or other parts of bookmarks using the Edit
  298. Bookmark‚Ķ menu item.  Unless you understand the Gopher protocol we
  299. don't recommend that you change anything except perhaps the title (name)
  300. of a Bookmark.
  301.  
  302. You can save your Bookmarks window or ANY list window or ANY
  303. selected item as a Bookmark file ('Save as Bookmark File‚Ķ' menu
  304. item).  Bookmark files are small and may be exchanged with other
  305. Gopher users if you wish.   If you know what you are doing, Bookmark
  306. files may be edited with permissive text editors.
  307.  
  308. The 'Import Bookmarks‚Ķ' menu item lets you read a Bookmark file
  309. right into your Bookmarks window. The 'Open Gopher Bookmark File‚Ķ'
  310. menu item on the other hand, places the contents of a bookmark file
  311. in a window of its own. The latter is equivalent to double-clicking
  312. on bookmark files from the Finder. If you launch TurboGopher by
  313. double-clicking on a bookmark file, it will not immediately connect
  314. to the Home Gopher server, but will open the Bookmark file instead.
  315. So you may use bookmark files as custom Home Gopher servers.
  316.  
  317.  
  318. ======      Item Attributes      ======
  319.  
  320. More sophisticated Gopher servers (referred to as Gopher+ servers)
  321. can provide you with information about any selected item, much like
  322. the Finder's Get Info menu lets you get information about a Mac item.
  323.  
  324. Use the 'Get Attribute Info' menu item of the Gopher menu for this.
  325.  
  326.  
  327. ======      Canceling Slow Network Operations      ======
  328.  
  329. TurboGopher executes most requests in a few seconds. A document or 
  330. directory is displayed as it is received. However, if a server is 
  331. especially slow or busy or if you have started to fetch what appears 
  332. to be a very long and uninteresting document or directory, you may 
  333. cancel the fetching process by closing the document or directory 
  334. window. Once you have closed the window, TurboGopher assumes that it 
  335. does not need to fetch the remainder of the item. Note that when you 
  336. fetch a file that is saved to your Mac disk, TurboGopher displays a 
  337. window with the status of the transaction. Again, to cancel, you can
  338. simply close the window.
  339.  
  340. A more extreme method for canceling a network operation is to choose 
  341. the Cancel All Requests item from the Gopher menu (or by holding 
  342. down the command key and typing a period). If you open a file or folder 
  343. by double-clicking while holding down the Option key (to conserve 
  344. screen space as described earlier), TurboGopher will also cancel the 
  345. running network transaction if one is outstanding; and this is in fact 
  346. exactly what you want over low speed connections such as SLIP. Both 
  347. these features make TurboGopher seem faster and more responsive 
  348. over SLIP links.
  349.  
  350. TurboGopher runs happily in the background (if you wish to fetch 
  351. something very large or from a very slow server). You may also fetch an 
  352. item (file or directory) while another one is still being fetched, since 
  353. TurboGopher supports multiple concurrent streams.  Command-Period 
  354. cancels all active streams.
  355.  
  356.  
  357. ======      Starting and  Configuring TurboGopher      ======
  358.  
  359. The 'Start Gopher' item under the File menu opens a window containing 
  360. the initial directory fetched by connecting to your home Gopher server. 
  361. TurboGopher is pre-configured to connect on startup to one of the 
  362. University of Minnesota's Gopher servers. You may change your home 
  363. Gopher server by using the 'Configure' item under the Setup menu. To 
  364. do this you need the full Internet domain name and port of the desired 
  365. primary server. You can configure TurboGopher to use one of two 
  366. alternate primary servers. This distributes the load for a campus over two
  367. different (but equivalent) primary servers and it prevents a single
  368. point of failure. TurboGopher will randomly try one of the two and
  369. then try the other if the first is down.  If you don't understand 
  370. this, you don't have to bother with it or with the Another Gopher item 
  371. under the File menu.
  372.  
  373. TurboGopher attempts to speak Gopher+ to all Home Gopher servers,
  374. and then backs off if it sees that the server does not have Gopher+
  375. style items. This is a bit presumptuous, and it confuses some
  376. servers. These servers should be revised in the future so they
  377. don't confuse so easily. If configured to connect to a Home Gopher
  378. server and nothing is displayed, you  may want to try using the
  379. 'Another Gopher' item under the file menu and  making sure that the
  380. Gopher+ check box is NOT checked.
  381.  
  382.  
  383. ======      TurboGopher Options    ======
  384.  
  385. You can use the Options item under the Setup menu to customize some 
  386. behaviors of TurboGopher. The Single Directory Window checkbox 
  387. makes TurboGopher recycle its windows whenever you open a new 
  388. directory (and not just when you hold down the Option key).
  389.  
  390. Use the ISO Latin-1 checkbox if you need to use Latin/Romance 
  391. language characters. Many sites in Europe have a need for this to 
  392. display their national characters. If you visit European gopher servers 
  393. and the accented characters don't display correctly, you may want to 
  394. choose this option.  
  395.  
  396. The Extended Directory listings checkbox is disabled; it's for a future feature.
  397.  
  398. If you visit Gopher servers with Japanese or Chinese documents, and 
  399. you use a Japanese or Chinese font while running System 7.1's 
  400. WorldScript, Gopher will display Japanese SJIS (MS Kanji) or traditional 
  401. Chinese characters (BIG-5). 
  402.  
  403. When you save documents, TurboGopher normally saves them as 
  404. MacWrite II TEXT documents (we like MacWrite II).  If you'd rather
  405. save them as TEXT documents of your favorite word processor or
  406. editor, use the appropriate 'Set‚Ķ' button in the Options dialog
  407. to select the word processor of your choice.  
  408.  
  409. With Gopher+ servers, items may be available in a number of alternate
  410. views.  When fetched, these alternate views are typically saved as a 
  411. file to be viewed by a Mac application.  If you are a network/macintosh 
  412. cowboy, you can change the Mac application and Mac filetype 
  413. associated with a Gopher+ alternate view.... this changes the helper 
  414. application that TurboGopher asks the finder to launch to view the 
  415. document.  Double-click the view in the list and you will be presented 
  416. with a dialog in which you can select the application to be used as a 
  417. TurboGopher helper.
  418.  
  419. By the way, you won't be able to do this if you're running System 6...
  420.  
  421.  
  422. ======      Miscellaneous      ======
  423.  
  424. TurboGopher saves or caches the item lists for all visited directories
  425. (even when windows are closed).  Since these lists don't ever have to be
  426. fetched from the server again, this dramatically increases speed when
  427. choosing any item from the Recent menu.  If TurboGopher runs out of
  428. memory it will release the caches for closed windows.  Closing unneeded
  429. windows will reduce TurboGopher's memory needs.   If you browse
  430. many large directories and documents, we recommend that you increase
  431. TurboGopher's memory allocation.  Do this by clicking once on the 
  432. TurboGopher icon in Finder and then doing a Get Info in Finder.  Set
  433. the memory allocation up in the ensuing dialog box.
  434.  
  435. TurboGopher stores what it needs in a file called TurboGopher Settings; 
  436. this lives in the Preferences folder, which is found in your System Folder.
  437. If you drag this file out from the Preferences folder and place it in the 
  438. same folder as TurboGopher, it will still be found and used.
  439.  
  440.  
  441. ======      For Experts      ======
  442.  
  443. If you are a campus or department network administrator, and you would 
  444. like information about pre-configuring internal defaults, read the short 
  445. Inside TurboGopher document.  This is available in the Gopher software 
  446. distribution from the University of Minnesota's Gopher server, along with 
  447. with the current version of TurboGopher itself.  You may send e-mail to 
  448. the Gopher Team at:                 
  449.  
  450.              gopher@boombox.micro.umn.edu
  451.  
  452. Please write to the development team (at the above address) with bugs, 
  453. suggestions, or (of course!) praise. To be informed by e-mail of new 
  454. developments in the Gopher world, or of new versions of Gopher 
  455. software, you may subscribe to 'gopher-news'; Send your request to:
  456.  
  457.        gopher-news-request@boombox.micro.umn.edu. 
  458.  
  459. Have fun surfing the Internet...
  460.  
  461. - The internet Gopher Team at the University of Minnesota    
  462. April 20, 1993.
  463.  
  464.  
  465. -------------------------------------------------
  466. ...and now, to keep the lawyers happy...
  467.  
  468. The Gopher software and documentation is copyright ¬© 1991 - 1993
  469. by the University of Minnesota.
  470.  
  471. Permission to use, copy, modify, and distribute this software and
  472. documentation for non-commercial purposes and without fee is hereby
  473. granted, provided that the University of Minnesota copyright notices and
  474. this permission notice appear in all copies, and that the name
  475. University of Minnesota not be used in advertising or publicity
  476. pertaining to this software and documentation without specific, written
  477. prior permission. The University of Minnesota makes no representations
  478. about the suitability of this software and documentation for any
  479. purpose.  It is provided 'as is' without express or implied warranty. 
  480.  
  481. Commercial use of Gopher requires specific permission from the
  482. University of Minnesota; contact the internet gopher development team at
  483. gopher@boombox.micro.umn.edu for further information.  
  484. -------------------------------------------------